home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_FileRunner.idb / usr / freeware / lib / FileRunner2.5 / README.z / README
Encoding:
Text File  |  1999-01-26  |  6.8 KB  |  251 lines
  1.  
  2.  
  3.  
  4. FILERUNNER
  5. ==========
  6.  
  7. Version 2.5
  8.  
  9. (C) 1996-1998 Henrik Harmsen
  10.  
  11. FileRunner is an X11 file manager for Unix. It is simple and efficient
  12. and has a built-in FTP client.
  13.  
  14. FEATURES
  15. ========
  16.  
  17.   * Simple and powerful interface.
  18.   * History and Hotlist (bookmarks).
  19.   * Recursive directory menu of entire file system tree.
  20.   * Browse FTP directories as easy as normal directories.
  21.   * FTP capabilities:
  22.     - Copy: FTP files/directories upload/download (recursive).
  23.     - FTP Delete (recursive), FTP Makedir, FTP Rename.
  24.     - Supports FTP through proxy.
  25.     - FTP resume download function.
  26.     - Rule based configuration of FTP site logins (password/user/proxy).
  27.     - Asynchronous file transfer.
  28.     - Cached directory listings.
  29.   * Asynchronous file operations.
  30.   * Built-in command shell windows. Synchronized with file panels.
  31.     These have history, aliases and file name completion.
  32.   * Extendable by adding your own command buttons.
  33.   * Very configurable.
  34.   * User defined file pattern / actions. (*.jpg -> launch image viewer etc.)
  35.   * Distributed under the GNU General Public License.
  36.  
  37. REQUIREMENTS
  38. ============
  39.  
  40. * A standard Unix platform.
  41. * Tcl/Tk 8.0 or later.
  42. * An ANSI C compiler if you can not use the precompiled binaries.
  43.  
  44. FileRunner does not need rebuilding the wish binary. It uses the
  45. binary extension mechanism in Tcl to add commands written in C.
  46.  
  47.  
  48. COMPATIBLE PLATFORMS
  49. ====================
  50.  
  51. FileRunner has been verified to work on:
  52.  
  53.  - Linux
  54.  - SunOS 4.x
  55.  - Solaris 2.x
  56.  - Irix 5.x
  57.  - UnixWare 2.x
  58.  - HP-UX
  59.  - Dec Alpha OSF (Digital Unix)
  60.  - FreeBSD
  61.  - SCO OpenServer
  62.  - AIX
  63.  - NetBSD
  64.  
  65.  
  66. INSTALLATION
  67. ============
  68.  
  69. Installation is fairly simple. The main thing to note here is that you
  70. unpack directly to where the stuff is to be installed. You never do a
  71. "make install". 
  72.  
  73.  
  74.   0. If you have installed through a RedHat rpm package.
  75.   ------------------------------------------------------
  76.  
  77. If you have obtained FileRunner in a RedHat rpm, then all of this is
  78. done. The program should be possible to start by running:
  79.  
  80.   $ fr &
  81.  
  82. Possibly you need to run "rehash" in your shell first. Then you can
  83. skip the rest of this chapter. Otherwise, there are a few simple steps
  84. to follow:
  85.  
  86.   1. Unpack
  87.   ---------
  88.  
  89. The first step is to get the archive unpacked.
  90. Example:
  91.  
  92.   $ cd /usr/local/lib
  93.   $ gzip -cd FileRunner-2.5.tar.gz | tar xf -
  94.   $ cd FileRunner-2.5
  95.  
  96. You don't have to install in /usr/local/lib, you can install anywhere,
  97. just make sure the link in step 3 is correct.
  98.  
  99.  
  100.   2. Fixing an ext.so file
  101.   ------------------------
  102.  
  103. FileRunner needs a library of functions that have been written in C. The
  104. necessary library has been precompiled on a few platforms.
  105.  
  106. - If you are running Linux on an Intel machine, this is done. Go to step 3.
  107.  
  108. - If you are running SunOS 4.1.x on a Sparc machine, copy
  109.   ext.so.sunos4_sparc to ext.so, then go to step 3.
  110.  
  111. - If you are running Solaris 2.5 or later on a Sparc machine, copy
  112.   ext.so.sunos5_sparc to ext.so, then go to step 3.
  113.  
  114. Otherwise:
  115.  
  116. If you don't have any of the above, you should try to build it
  117. yourself. There are a bunch of Makefiles in the "Makefiles" directory
  118. to try. Pick one of the Makefiles you think might work and edit it to
  119. reflect the platform you are using. It's a tiny Makefile, so it
  120. shouldn't be too difficult. When choosing a makefile to edit, the
  121. first choice should be a pre-existing makefile with the same OS, not
  122. the same compiler. When you have edited the makefile run:
  123.  
  124.   $ make -f Makefiles/Makefile.xxx
  125.  
  126. When you have an ext.so file you can try it out by running the "fr"
  127. script: "./fr &"
  128.  
  129. If you have previously installed and built an earlier version of
  130. FileRunner, then you can avoid rebuilding the ext.so file by copying
  131. that from the older build. Just check that ext.c hasn't changed
  132. between the old installation and the new (if it has, you need to
  133. rebuild). One day when I have loads of time on my hands I might
  134. consider using the GNU autoconf utility to avoid this mess of
  135. Makefiles... :-)
  136.  
  137.  
  138.   3. Making a soft link
  139.   ---------------------
  140.  
  141. The final stage of installation is to soft-link the fr script to where
  142. you want installed in your path. If you want it in /usr/local/bin, and
  143. you unpacked the FileRunner archive under /usr/local/lib, you do the
  144. following:
  145.  
  146.   $ ln -s /usr/local/lib/FileRunner-2.5/fr /usr/local/bin/fr
  147.  
  148. It's important you make this a soft link and not just copy it. If you
  149. don't, FileRunner will not find the rest of itself and will not start
  150. up. It uses the link to find the necessary stuff it needs.
  151.  
  152. Last note: There is an icon GIF file "fr.gif" you can use if you need an
  153. icon for FileRunner. I've tried to make a color icon default for
  154. FileRunner but I can not figure out how to do this in Tcl/Tk...
  155.  
  156.  
  157.   4. If you installed as root
  158.   ---------------------------
  159.  
  160. If you have installed FileRunner as root you probably have erroneous
  161. owner/group id's of the installed files. Do the following (as root):
  162.  
  163.   # chown -R root FileRunner-2.5
  164.   # chgrp -R root FileRunner-2.5
  165.   # chmod -R go-w FileRunner-2.5
  166.  
  167. To fix permissions and ownership of the files.
  168.  
  169.  
  170. WHERE TO GET FILERUNNER
  171. =======================
  172.  
  173. Use one of these sites:
  174.  
  175. http://www.cd.chalmers.se/~hch/filerunner.html
  176. ftp://sunsite.unc.edu/pub/Linux/X11/desktop/FileRunner-2.5.tar.gz
  177.  
  178.  
  179. WHERE TO GET TCL/TK
  180. ===================
  181.  
  182. Please see the web page at
  183. http://www.cd.chalmers.se/~hch/filerunner.html
  184.  
  185.  
  186. COMMON PROBLEMS
  187. ===============
  188.  
  189. See the FAQ-file in the installation. Please also see chapter 13 in
  190. the online guide.
  191.  
  192.  
  193. KNOWN BUGS
  194. ==========
  195.  
  196. Please see the file KnownBugs.txt.
  197.  
  198.  
  199. E-MAIL LIST WITH ANNOUNCEMENTS
  200. ==============================
  201.  
  202. Mail me if you are interested to be on the FileRunner announcement
  203. mailing list. I won't send announcements of every release to the
  204. newsgroups so if you want to know if a new release is out you should
  205. either check the web page regularly or join the list.
  206.  
  207.  
  208. FILERUNNER IS OPEN SOURCE SOFTWARE
  209. ==================================
  210.  
  211. FileRunner is Open Source software and is distributed under the GNU
  212. General Public License. If you like it, send me a cool postcard so I
  213. can fill the front of my fridge :-) See the end of the User's Guide
  214. for my address.
  215.  
  216. FileRunner is Copyright (C) 1996-1998 Henrik Harmsen.
  217.  
  218.  
  219.   Henrik Harmsen
  220.  
  221. Email:
  222.   hch@cd.chalmers.se
  223.   Henrik.Harmsen@erv.ericsson.se
  224.  
  225. For more contact info see online guide.
  226.  
  227.  
  228. ADDENDUM
  229. ========
  230.  
  231. Note 1, The Debian distribution
  232. -------------------------------
  233.  
  234. This note is to the manager of the Debian distribution.
  235.  
  236. To have the documentation for FileRunner somewhere other than in the
  237. distribution directory (where all the other FileRunner stuff is):
  238. Create a file in the distribution directory called "config" and put
  239. the following line into this:
  240.  
  241. set glob(doclib_fr) /usr/local/doc/FileRunner
  242.  
  243. (Adjust it to the correct location). Then copy over the documentation
  244. to this directory. See the online guide, chapter 6, about the
  245. system-wide config file.
  246.  
  247.  
  248.  
  249.  
  250.  
  251.